Skip to main content

Datadog

Supported Data Types: Trace Metrics Logs RedMetric ServiceInstance Topology

This document is for integrating Datadog's Trace Metrics Logs RedMetric ServiceInstance Topology data into Syncause.

  • You need access to a running Syncause service to complete this tutorial. For instructions, please refer to the "Setup" section.
  • You need a Datadog account with relevant Datadog features enabled.
  • Access Syncause's Ingestion > External Data Sources > Click Datadog to create a new Datadog data type.

Parameter Description

ParameterDescriptionExample
Data Source nameData source namemy-datadog
CommentData source comment
DataDog SiteDataDog Sitesdatadoghq.com
DataDog API KeyDataDog API keyjyb2t7i6pw2kac9aqxbp9o7vuund76z5
DataDog APP KeyDataDog Application keyk6rjtb893udmchgforrxuin7e5f5cazfkykrmv27
DataDog envDataDog env. For multiple environments, create separate DataDog integrations for each.dev

Detailed Instructions

DataDog Site

Confirm the SITE PARAMETER for your DataDog region on the official DataDog website, and fill in the DataDog Site parameter.

Getting Started with Datadog Sites

DataDog API Key

Create API Keys

Click the user avatar at the bottom left -> select API Keys.

Click + New Key, enter a name for the API Key, and confirm.

Copy the newly created API Key and fill it into the DataDog API Key parameter.

DataDog APP Key

Create Application Keys

Click the user avatar at the bottom left -> select Application Keys.

Click + New Key, enter a name for the Application Key, and confirm.

Copy the newly created Application Key and fill it into the DataDog APP Key parameter.

Application Keys Permissions

Application Keys default to Not Scoped, meaning full access is granted, and users can use them without any adjustments. If you want to implement minimal permission management, Syncause data integration requires Application Keys to have the following permissions:

  • apm_read
  • timeseries_query
  • logs_read_data
  • logs_read_index_data

Edit Application Keys Permissions

Click the user avatar at the bottom left -> select Application Keys.

Select the Application Key created for Syncause integration.

Click the Edit button next to Scope.

In the Scope list, select the minimal permissions as described in the "Application Keys Permissions" section above, and save at the bottom right.

DataDog env

Select the environment variable for the application to be monitored, and fill it into the DataDog env parameter. For multiple environment variables, create multiple DataDog integrations for management.